home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1991 …esperately Seeking Seven / Desperately Seeking Seven.hdv / Dev.CD.8 / Essentials / Utilities / GSBug / Read.Me < prev    next >
Encoding:
Text File  |  1990-12-03  |  7.3 KB  |  141 lines  |  [04] ASCII Text (0x0000)
  1.                 GSBug & Debugging Tools Update Release Notes
  2.                                    1/3/91
  3.  
  4.  
  5. This folder contains the latest pre-release version of GSBug & Debugging
  6. Tools.  These tools are useful with or without either the APW or ORCA
  7. development environments (i.e.: if you're using Merlin, Micol, TML, MPW IIGS,
  8. or any other development environment to write Apple IIGS software, then these
  9. tools (especially GSBug) will be VERY useful in finding bugs in the software
  10. you're developing.
  11.  
  12. These tools are a fully copyrighted work of Apple Computer, Inc and may NOT be
  13. redistributed.  They are being provided to you for your own use as our way of
  14. saying, "Thanks for developing for the Apple IIGS".  All Rights Reserved.
  15.  
  16. Futher information on using GSBug itself can be found in the "GSBug.Tutorial"
  17. file in the same folder as this "Read.Me" file.  Details on how to use the new
  18. "calls" that have been added to GSBug can be found in the "GSBug.Specs" file
  19. which is also in the same folder as this "Read.Me" file.  Reading those two
  20. files will explain a LOT of things to you.  The tutorial is especially useful
  21. if you do not have the manual (or you have the manual, but never bothered to
  22. read it).
  23.  
  24. The tutorial and specs files will only teach you the basics, there is a LOT
  25. more that can be done with GSBug, but you'll need the manual to be able to
  26. tap into them.  The 140 page manual for GSBug & Debugging Tools contains full
  27. details on how to use these tools.  Those of you without this manual can get
  28. one by contacting APDA at 1-800-282-2732 (in the U.S.), 1-800-637-0029 (in
  29. Canada), and 408-562-3910 (International).  The part number for this package
  30. is "A0037LL/A" and the price is thirty dollars ($30).
  31.  
  32. GSBug best supports debugging of 16-bit software.  Recent changes made to it
  33. provide minimal functionality for debugging 8-bit software. Please read the
  34. "GSBug.Specs" file for details.
  35.  
  36. ONLY the INIT version of GSBug is being provided.  The application version is
  37. most likely going to "go away" in the future.  Instead, we'll provide an easy
  38. way for you to install and remove the INIT version on the fly.  Currently, you
  39. can remove the INIT version after booting by simply entering the debugger (the
  40. tutorial file tells you how) and typing "UNLOAD", then pressing RETURN.  This
  41. removes the debugger.  If your application crashed into the debugger and you
  42. unload the debugger, your application will still be crashed (but into the
  43. monitor now that GSBug is gone).  If your application is NOT crashed (i.e.:
  44. you entered the debugger by pressing the key sequence that drops you in
  45. safely), then unloading GSBug will resume operation of your application as
  46. though nothing happened (actually, plenty happened - GSBug was removed from
  47. memory and you can't drop into it any more because it's gone).
  48.  
  49. If you use the application named "IR" (short for "INIT Runner") then you can
  50. reload GSBug on the fly.  Simply follow the directions supplied with IR to
  51. reload the INIT.  Otherwise, you have to reboot to reinstall the INIT version
  52. of GSBug.
  53.  
  54. Having only the INIT version solves several problems you would have
  55. encountered had you tried using the application version of GSBug along with an
  56. application that uses resources.  GSBug is technically the "current"
  57. application, so calls to the Resource Manager would actually look in GSBug's
  58. resource fork (which is non-existant) instead of your application's.  The INIT
  59. version prevents this conflict (and several other similar ones caused by
  60. confusion of which app is the "current" one).
  61.  
  62. Directions for installing theses tools are below:
  63.  
  64. GSBug & Debugging Tools installation:
  65.    - copy the files in the "GSBug/System.Setup/" folder
  66.      to your boot disk's System.Setup folder (full path would be:
  67.      "*/System/System.Setup/").  This will provide you with the INIT version
  68.      of GSBug the next time you boot your computer from the disk you just
  69.      installed onto.  It will also provide you with the templates for toolbox
  70.      data structures (such as grafPorts, windows, menu bars, etc).
  71.      Information on using the templates can be found in the "Templates.Info"
  72.      file.  General info on using templates of your own with GSBug can be
  73.      found in the GSBug Reference manual (available from APDA).
  74.  
  75.    - copy the desk accessories in the "GSBug/Desk.Accs/"
  76.      folder to your boot disk's Desk.Accs folder (full path would be:
  77.      "*/System/Desk.Accs/").  This will provide you with additional debugging
  78.      tools such as loader/dumper, memory mangler, scrambler, and snooper.  You
  79.      must reboot from the disk you just installed onto in order for those desk
  80.      accessories to show up.
  81.  
  82.    - copy the Exerciser application to where ever you normally install your
  83.      applications.  It doesn't really care what folder it lives in.  There is
  84.      a desk accessory version of the Exerciser, so you don't HAVE to use the
  85.      application version if you don't want to.
  86.  
  87.    - copy the INIT Runner (IR) application (inside the IR folder which is at
  88.      the same level as this "Read.Me" file) to where ever you normally install
  89.      your applications.  It doesn't really care what folder it lives in.
  90.      There is an icon file (IR.icons) that goes with it (so you can just
  91.      double-click the debugger.init from the Finder as though it were a data
  92.      file for IR).  You'll need to copy this icon file to your boot disk's
  93.      ICONS folder (or to whatever disk you install IR on) and edit the
  94.      application pathname of IR's icons for INITs, etc in order for the
  95.      Finder to know where you've installed IR.  The IR folder also contains
  96.      documentation for using IR, so please read it.  Otherwise, you may not be
  97.      able to get IR to work for you (you don't launch IR like a normal app, it
  98.      ONLY looks for its info in the Message Center - you HAVE to double click
  99.      on an icon that it knows about in order for IR to install things on the
  100.      fly.)  Like I said, there's documentation for IR in the IR folder, read
  101.      it...
  102.  
  103.  
  104. Double check your */System/System.Setup folder to be certain that you have
  105. ONLY one copy of the GSBug INIT file.  The old name for this file is
  106. "GSBug.INIT" and some pre-release versions went out with the INIT named
  107. "debug.INIT".  Having two copies of GSBug will cause nasty things to happen
  108. since both copies would be trying to do the same thing.  One GSBug is all you
  109. need.
  110.  
  111.  
  112.  
  113.       DISCLAIMER OF WARRANTY
  114.  
  115.       THE SOFTWARE IS PROVIDED "AS IS" WITHOUT
  116.       WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
  117.       WITH RESPECT TO ITS MERCHANTABILITY OR ITS FITNESS
  118.       FOR ANY PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO
  119.       THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
  120.       YOU.  SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU (AND
  121.       NOT APPLE OR AN APPLE AUTHORIZED REPRESENTATIVE)
  122.       ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING,
  123.       REPAIR OR CORRECTION.
  124.  
  125.       Apple does not warrant that the functions
  126.       contained in the Software will meet your requirements
  127.       or that the operation of the Software will be
  128.       uninterrupted or error free or that defects in the
  129.       Software will be corrected.
  130.  
  131.       SOME STATES DO NOT ALLOW THE EXCLUSION
  132.       OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY
  133.       NOT APPLY TO YOU.  THIS WARRANTY GIVES YOU SPECIFIC
  134.       LEGAL RIGHTS AND YOU MAY ALSO HAVE OTHER RIGHTS
  135.       WHICH VARY FROM STATE TO STATE.
  136.  
  137.  
  138. Tim Swihart
  139. APW & MPW IIGS Product Manager
  140. Apple Computer, Inc.
  141.